home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Panorama / Panorama - Disk 17B (1987-05-13)(Pacific North-West Amigas Club)[WB].zip / Panorama - Disk 17B (1987-05-13)(Pacific North-West Amigas Club)[WB].adf / Jobs2.1 / JOBS.DOC < prev    next >
Text File  |  1987-04-23  |  6KB  |  143 lines
  1. This program is Share Ware:  use it, copy it, or send it to another BBS
  2. but gratuities are appreciated.  See below for E-Mail & US-Mail addresses.
  3.  
  4. WHAT IS IT ?
  5. JoBS can be used instead of the WorkBench or the CLI window as a more
  6. effective system/user interface.
  7.  
  8. New with V2.1 more filenames allowed in directory tables (500), the definition
  9. file may be supplied as an argument from CLI or else from the Ram: directory.
  10. In order to speed-up modem transfers, only required files are included. 
  11.  
  12. The program provides instant access to various WorkBench and CLI commands by
  13. simply selecting control buttons.  Also, 28 control buttons can be defined by
  14. the user, by editing JoBS.def and 10 text input buttons can be defined to
  15.  access any storage device (ie. df0: df1: df2: dh0: ram: vd0:).
  16.  
  17. JoBS allows the user to invoke most WB programs or CLI commands by simply
  18. selecting it with the mouse then selecting the "Run" gadget button.
  19. The user can select with the mouse any filenames for programs that use
  20. filenames as command line parameters, such as text editors or file utilities
  21.  
  22. JoBS displays a window that has a message field with 40 control buttons on
  23. the left-half of the window.  The right-half shows a list of files in the
  24. current directory and the "Dir>" field shows name of the current directory.
  25. There are over 6 ways to select the current directory and 3 gadgets to locate
  26. filenames.  The "Use>" field is for text input and there are 6 more buttons
  27. just to help avoid typing.  The "Use>" text field may be used to enter a new
  28. sub-directory name or an entire CLI command.
  29.  
  30. The window of filenames also shows the number of days since the file was modified,
  31. the time it was modified, and the file size.  
  32.  
  33. The "Parms" control button is used to invoke a command in the Use> field and 
  34. pass selected filename as parameters, ie. Use> Arc A 
  35.  
  36. "Execute" acts on selected filename or the Use> field.
  37.  
  38. Tasks can be run as a "SubTask", or invoked as "OneTask" without contention.
  39.  
  40. "Copy", "Rename" and "MakeDir" require the Use> field. 
  41. "Delete" acts on selected filenames or the Use> field.
  42. "Del-Dir" removes a current/empty directory. 
  43.  
  44. To enter a directory, just select the directory name.
  45. To back-out of a directory select "Parent".
  46.  
  47. "All" will select/deselect all filenames.
  48. "Select" will copy a selected filename to the Use> field.
  49. "Clear" will erase text from the Use> field.
  50.  
  51.  
  52. HOW TO RUN ?
  53. Type:   JoBS df#:path/JoBS.def  (or)  RUN JoBS my.def  (or) click a JoBS icon 
  54. or include the JoBS statement in your s:startup-sequence.  If you leave off
  55. the command line argument, JoBS looks for;  Ram:JoBS.def
  56.  
  57. HOW TO CUSTOMIZE ?
  58. JoBS automatically reads JoBS.def to initialize the display window.
  59. The user can easily redefine 28 of the control buttons, and the storage devices
  60. after the program has started by selecting a definition file and then selecting the
  61. "Define" control button.  Look at the sample JoBS.def file. 
  62.  
  63. The first record of the definition file will display in the message window.
  64.  
  65. The second record defines the storage devices.  Each device name has 4 chars.    
  66.  
  67. The next 28 records define each control button, using 3 types of fields.
  68.  - First field in each record is a button label upto 7 chars, no imbedded blanks.
  69.  - Space chars are used to separate each field. 
  70.  - The second field is one character, either "?" or "-".
  71.  - The "?" is used to query the user with a requester gadget before
  72.    a command is invoked.  The "-" dashes into the command without a requester. 
  73.  - The function field can be upto 72-characters with imbedded blanks.
  74.  - The characters "%s" are used to substitute parameters and "%0.0s" is
  75.    used to ignore parameters.  
  76.  - The first "%s" will substitute the OneTask or SubTask Mode.
  77.  - The second "%s" will substitute the filename(s) selected, if no filenames
  78.    are selected then the Use> text field will be substituted.
  79.  - The third "%s" is only used when you want to capture both filename and Use>.
  80.  - The fourth "%s" is only used when you need:  Use> field then filename order,
  81.    in this case you will normally have the second "%s" as "%0.0s" instead.
  82.  
  83. Some of the functions send their output to the console, aka. CLI window.
  84. Programs that prompt for user input from the console may not work properly,
  85. like DIR OPT I, but with JoBS you really don't need DIR old command anymore. 
  86. So keep a small CLI window handy for odd-jobs. 
  87.  
  88. If you have any questions or comments, send E-mail to John Sawaya, on PhilAmiga BBS
  89. 533-3191, or AmigaInfo BBS 430-3969.  US-mail to 415 Charleston Greene, Malvern PA
  90. 19355.
  91.  
  92. Sample definition file:
  93.  
  94. Welcome to JoBS! 
  95. vd0: ram: df0: df1: df2:
  96. Blitz   - %s Blitz %s    ; Comments can be put here after the ';'
  97. TxEd    - %s E %s        ; But note, this whole line will be displayed
  98. uEdit   ? %s UE %s %s    ; for a Requester '?' and in the small Message field.
  99. Help?   - Read JoBS.Readme
  100. Prefs   ? Preferences
  101. LoadWB  ? LoadWB ;WorkBench 
  102. PathAdd ? %0.0s Path Add %s
  103. RamOff  ? Run RamOff
  104. Clock   - Run Clock 
  105. Monitor ? Run PM ;Performance Monitor
  106. FreeSpc - Execute s:Free.exec
  107. DskInfo ? %0.0s Run Inf %4.4s  
  108. QikCopy ? QuikCopy
  109. Format  ? %s Format Drive %4.4s Name Data
  110. PC-Fmt  ? Run PCformat
  111. PC-Copy ? %s PCcopy 
  112. df2:Mnt ? Mount df2:
  113. df2:Chg ? DiskChange df2:
  114. Make    ? %s Execute Make %s %s 
  115. MakeRam ? %s Execute LC:MakeRam
  116. Arc     ? %s Arc %0.0s %s %s 
  117. UnArc   ? %s UnArc %s
  118. MakeAcv ? %s MakeAcv %s
  119. LoadAcv ? %s LoadAcv %s 
  120. ShowIff - %s Show %s %s
  121. SaveIff ? %s SaveILBM <Sys:SaveILBM.Input %s
  122. PrtScrn ? GraphicDump
  123. Print   ? %s Copy %s to Prt:  
  124. -------------------- Only the first 30 records are input ----------------------
  125. Echo    ? %s Echo >ram:temp %s
  126. Search  ? %s Execute sys:s/Search.exec %s %s 
  127. Scribb! ? %s Scribble!:Scribble! %s 
  128.  
  129. ... so you can use this area for notes or whatever. The Echo button could be 
  130. used to select Iff files for building SlideShow input file!  Check-out Search
  131. for finding things, like references in "include" files?  How that for an
  132. open-ended program.  Please let me know if you have new ideas for applications
  133. or enhancements.  I have spent several months to develop this program and use
  134. it instead of WB/CLI for speed and capability. OnLine! seems to prefer
  135. "Select-the-program"&"Run" method, while Scribble! can go into a button where you
  136. can select the document to edit or Use> a new document name!  
  137.  
  138. Did you notice JoBS V2.1 is many Kbytes smaller than JoBS V1.1? 
  139.  
  140. The next JoBS V3.0 will be out around May(87) with better windowing, and more! 
  141.    
  142.   John B.Sawaya
  143.